返回之前创建过 transfer
对象的一个列表。列表是按创建时间进行排序,总是将最新的 transfer
对象显示在最前。如果不设置 created 参数,默认查询近一个月的数据;设置了 created 参数,会按照对应的时间段查询。
请求参数 | 描述 |
---|---|
app[id] expandable optional string | 转账使用的 app 对象的 id ,expandable 可展开,查看如何获取App ID。 |
limit optional int | 限制每页可以返回多少对象,范围为 1~100 项,默认是 10 项。 |
starting_after optional string | 在分页时使用的指针,决定了列表的第一项从何处开始。假设你的一次请求返回列表的最后一项的 id 是 obj_end ,你可以使用 starting_after = obj_end 去获取下一页。 |
ending_before optional string | 在分页时使用的指针,决定了列表的最末项在何处结束。假设你的一次请求返回列表的第一项的 id 是 obj_start ,你可以使用 ending_before = obj_start 去获取上一页。 |
created optional timestamp | 对象的创建时间,用 Unix 时间戳表示,具体参考下表 created 参数。 |
channel optional string | 付款使用的第三方支付渠道名称。目前支持 wx (微信 App)、wx_pub (微信 JSAPI)、wx_lite (微信小程序)、alipay (支付宝)、unionpay (银联电子代付)、allinpay (通联代付)、jdpay (京东代付)和balance (余额)。 |
status optional string | 付款状态。目前支持 4 种状态:pending: 处理中; paid: 付款成功; failed: 付款失败; scheduled: 待发送。 |
type optional string | 付款类型,转账到个人用户为 b2c,转账到企业用户为 b2b。 |
created 参数说明 | 描述 |
---|---|
created[gt] optional int | 大于 transfer 对象的创建时间,用 Unix 时间戳表示。 |
created[gte] optional int | 大于或等于 transfer 对象的创建时间,用 Unix 时间戳表示。 |
created[lt] optional int | 小于 transfer 对象的创建时间,用 Unix 时间戳表示。 |
created[lte] optional int | 小于或等于 transfer 对象的创建时间,用 Unix 时间戳表示。 |
返回
返回一个已存在的 transfer
对象的列表或者一个错误,详见 错误。
GET https://api.pingxx.com/v1/transfers?expand[]=app
\Pingpp\Transfer::all();
Transfer.all(Map options);
Pingpp::Transfer.all
pingpp.transfers.list();
pingpp.Transfer.all()
transfers.List(&TransferListParams)
list(Dictionary<String, Object> params)
curl https://api.pingxx.com/v1/transfers/?limit=3&expand[]=app -u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
\Pingpp\Pingpp::setApiKey('sk_test_ibbTe5jLGCi5rzfH4OqPW9KC');
\Pingpp\Transfer::all(array('limit' => 3));
Pingpp.apiKey = "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC";
Map<String, Object> transferParams = new HashMap<String, Object>();
transferParams.put("limit", 3);
Transfer.all(transferParams);
require "pingpp"
Pingpp.api_key = "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC"
Pingpp::Transfer.all(:limit => 3)
var pingpp = require('pingpp')('sk_test_ibbTe5jLGCi5rzfH4OqPW9KC');
pingpp.transfers.list({ limit: 3 }, function(err, transfers) {
// YOUR CODE
});
import pingpp
pingpp.api_key = 'sk_test_ibbTe5jLGCi5rzfH4OqPW9KC'
res = pingpp.Transfer.all(limit=3)
pingpp.Key := "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC"
params := &pingpp.TransferListParams{}
params.Filters.AddFilter("limit", "", "3")
Dictionary<String, Object> params = new Dictionary<String, Object>();
params.Add("limit", 3);
try {
TransferList trs = Transfer.list(params);
Console.WriteLine(trs);
} catch (Exception e) {
Console.WriteLine(e.Message.ToString());
}
{
"object": "list",
"url": "/v1/transfers",
"has_more": true,
"data": [
{
"id": "tr_HqbzHCvLOaL4La1ezHfDWTqH",
"object": "transfer",
"type": "b2c",
"created": 1432724825,
"time_transferred": null,
"livemode": true,
"status": "pending",
"app": "app_1Gqj58ynP0mHeX1q",
"channel": "wx_pub",
"order_no": "123456789",
"amount": 100,
"amount_settle": 100,
"currency": "cny",
"recipient": "Openid",
"description": "Your Description",
"transaction_no": "1000018301201505200184147302",
"failure_msg":null,
"extra": {
"user_name": "User Name",
"force_check": true
}
}
]
}